<html>
<body>                          
<h1>Remote Copy Plugin</h1>
<p>Copies files or artifacts to a remote server. It is primarily used for uploading aritfacts
    to a shared web server via WebDAV.
</p>
<div id="after-summary">
    <p><b>WebDAV Properties:</b></p>
    <p>The following properties control a WebDAV connection and are common to all tasks:</p>
    <table>
        <tr>
            <td>url</td>
            <td>The url of the WebDav server. e.g. https://quokka.ws:2078
            </td>
        </tr>
        <tr>
            <td>acceptInvalidCertificates</td>
            <td>If true, invalid certificates encountered during https processing will be ignored. Defaults to false.
            </td>
        </tr>
        <tr>
            <td>user</td>
            <td>The user for authenticating the WebDAV connection
            </td>
        </tr>
        <tr>
            <td>password</td>
            <td>The password for authenticating the WebDAV connection
            </td>
        </tr>
    </table>
    <p><b>Notes:</b></p>
    <ul>
        <li>If you are having problems, enabling debugging (command line <tt>-d</tt> option) will
        display the full http headers.</li>
        <li>Basic authentication is used, so make sure you are connecting via SSL (https) over
            public networks.</li>
        <li>Properties starting with <tt>q.rcopy.defaults</tt> will be used as defaults for configuring
        connections.</li>
    </ul>
</div>
<div id="copy-artifacts">
    <p>The copy artifacts template accepts separate connection settings for snapshots and releases. Artifacts
    will be copied to the correct location automatically.</p>
    <p><b>Note:</b> The artifacts are copied from the project's repository, so make sure the <tt>install</tt>
    target has been performed prior to copying (this can be automated by adding <tt>depends="install"</tt> to
    the target definition).</p>
    <p>The following is a typical example of using the copy-artifacts template. It uploads all artifacts
    defined in the current project to a remote server via WebDAV:</p>
<pre>&lt;target name="upload" template="copy-artifacts"&gt;
    &lt;property name="releases.url" value="https://quokka.ws:2078/releases"/&gt;
    &lt;property name="snapshots.url" value="https://quokka.ws:2078/snapshots"/&gt;
&lt;/target&gt;
</pre>
    <p><b>Properties:</b></p>
    <table>
        <tr>
            <td>protocol</td>
            <td>Currently, only webdav (the default) is supported.
            </td>
        </tr>
        <tr>
            <td>path</td>
            <td>If specified, the artifacts defined the project path given will be copied.
                If not specified, the artifacts created by the current project will be used.
            </td>
        </tr>
        <tr>
            <td>mount</td>
            <td>The root of some WebDAV configurations may not the root of the repository. Instead, it may
                be mounted part way down the repository. e.g. the root of the WebDAV server may be the
                apache/commons directory. This is usually done for security reasons to prevent certain users
                from modifying anything outside of a specific sub directory. In this case, the mount point
                must be specified, e.g. "/apache/commons"
            </td>
        </tr>
        <tr>
            <td>snapshots.* and releases.*</td>
            <td>Any of the WebDAV properties above will be used for establishing a WebDAV connection.
            </td>    
        </tr>
    </table>
</div>
<div id="copy">
    <p>The following is a typical example of using the copy template:</p>
<pre>&lt;target name="copy" template="copy"&gt;
    &lt;property name="file" value="/Users/andrew/file.txt"/&gt;
    &lt;property name="url" value="https://quokka.ws:2078"/&gt;
    &lt;property name="to" value="/somedir/somesubdir/file.txt"/&gt;
&lt;/target&gt;
</pre>
    <p><b>Properties:</b></p>
    <table>
        <tr>
            <td>protocol</td>
            <td>Currently, only webdav (the default) is supported.
            </td>
        </tr>
        <tr>
            <td>file</td>
            <td>A file on the local file system to copy
            </td>
        </tr>
        <tr>
            <td>to</td>
            <td>The full path of the destination file on the remote server
            </td>
        </tr>
    </table>
    <p>Any of the WebDAV properties above will be used for establishing a WebDAV connection.</p>
</div>
</body>
</html>